home *** CD-ROM | disk | FTP | other *** search
Wrap
ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) NNNNAAAAMMMMEEEE dmACSetParams, dmACGetParams - set/get the Audio Converter parameter values SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____aaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttt....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____aaaauuuuddddiiiioooouuuuttttiiiillll....hhhh>>>> DDDDMMMMssssttttaaaattttuuuussss ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss(((( DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr ccccoooonnnnvvvveeeerrrrtttteeeerrrr,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ssssoooouuuurrrrcccceeeeppppaaaarrrraaaammmmssss,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ddddeeeessssttttppppaaaarrrraaaammmmssss,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ccccoooonnnnvvvveeeerrrrssssiiiioooonnnnppppaaaarrrraaaammmmssss)))) DDDDMMMMssssttttaaaattttuuuussss ddddmmmmAAAACCCCGGGGeeeettttPPPPaaaarrrraaaammmmssss(((( DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr ccccoooonnnnvvvveeeerrrrtttteeeerrrr,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ssssoooouuuurrrrcccceeeeppppaaaarrrraaaammmmssss,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ddddeeeessssttttppppaaaarrrraaaammmmssss,,,, DDDDMMMMppppaaaarrrraaaammmmssss ****ccccoooonnnnvvvveeeerrrrssssiiiioooonnnnppppaaaarrrraaaammmmssss)))) PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS _c_o_n_v_e_r_t_e_r is a DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr handle created by a previous call to the creation method ddddmmmmAAAACCCCCCCCrrrreeeeaaaatttteeee(3dm). _s_o_u_r_c_e_p_a_r_a_m_s is a DDDDMMMMppppaaaarrrraaaammmmssss list describing the audio format of the data to be converted. _d_e_s_t_p_a_r_a_m_s is a DDDDMMMMppppaaaarrrraaaammmmssss list describing the audio format into which the data is to be converted. Any parameter not specified will default to the input value, with some exceptions (see below). _c_o_n_v_e_r_s_i_o_n_p_a_r_a_m_s is an optional DDDDMMMMppppaaaarrrraaaammmmssss list describing specific parameters relating to the conversion process itself. RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE Returns DDDDMMMM____SSSSUUUUCCCCCCCCEEEESSSSSSSS if the operation succeeds. If DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE is returned, the error number and/or message can be retrieved via ddddmmmmGGGGeeeettttEEEErrrrrrrroooorrrr(3dm). DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The handle passed to this routine is declared as follows: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt ____DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr ****DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr;;;; ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) configures an DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr handle, created via a call to ddddmmmmAAAACCCCCCCCrrrreeeeaaaatttteeee(3dm). The configuration is done via three DDDDMMMMppppaaaarrrraaaammmmssss lists, created by ddddmmmmPPPPaaaarrrraaaammmmssssCCCCrrrreeeeaaaatttteeee(3dm). The first param list specifies the format of the audio data to be converted. There are no defaults for the input format. The input specification must be complete or the call will fail. The second parameter list specifies the format into which the data is to PPPPaaaaggggeeee 1111 ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) be converted. Any parameter not specified here will default to the value present in the input parameter list, except DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____CCCCOOOOMMMMPPPPRRRREEEESSSSSSSSIIIIOOOONNNN, which defaults to DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____UUUUNNNNCCCCOOOOMMMMPPPPRRRREEEESSSSSSSSEEEEDDDD, and the DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPCCCCMMMM____MMMMAAAAPPPP parameters, which default to the appropriate values for the specified (or default) audio format. ddddmmmmAAAACCCCGGGGeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) queries a previously-configured DDDDMMMMaaaauuuuddddiiiiooooccccoooonnnnvvvveeeerrrrtttteeeerrrr handle for parameters relating to the audio conversion process. AAAAUUUUDDDDIIIIOOOO FFFFOOOORRRRMMMMAAAATTTT PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____FFFFOOOORRRRMMMMAAAATTTT Must be one of: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____TTTTWWWWOOOOSSSS____CCCCOOOOMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTT DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____FFFFLLLLOOOOAAAATTTT DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDOOOOUUUUBBBBLLLLEEEE DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____WWWWIIIIDDDDTTTTHHHH Must be an integer between 1 and 32. It is ignored if DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____FFFFOOOORRRRMMMMAAAATTTT is not set to one of the first two values. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____BBBBYYYYTTTTEEEE____OOOORRRRDDDDEEEERRRR Must be one of: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____BBBBIIIIGGGG____EEEENNNNDDDDIIIIAAAANNNN DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____LLLLIIIITTTTTTTTLLLLEEEE____EEEENNNNDDDDIIIIAAAANNNN DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____CCCCHHHHAAAANNNNNNNNEEEELLLLSSSS Must be an integer greater than 0. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRAAAATTTTEEEE Must be a double-precision floating point (type DDDDMMMM____TTTTYYYYPPPPEEEE____FFFFLLLLOOOOAAAATTTT) greater than 0.0. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____CCCCOOOOMMMMPPPPRRRREEEESSSSSSSSIIIIOOOONNNN The following parameter values are currently supported: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____UUUUNNNNCCCCOOOOMMMMPPPPRRRREEEESSSSSSSSEEEEDDDD DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGG777711111111____UUUULLLLAAAAWWWW DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGG777711111111____AAAALLLLAAAAWWWW DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____MMMMPPPPEEEEGGGG1111 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____MMMMUUUULLLLTTTTIIIIRRRRAAAATTTTEEEE DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGG777722222222 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGG777722226666 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGG777722228888 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDVVVVIIII DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____FFFFSSSS1111000011116666 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____GGGGSSSSMMMM DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDVVVV All compression-specific parameters such as DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____BBBBIIIITTTTRRRRAAAATTTTEEEE are also settable and queryable. See the man pages for the standalone compression routines (such as ddddmmmmGGGG777722222222EEEEnnnnccccooooddddeeeerrrrSSSSeeeettttPPPPaaaarrrraaaammmmssss(3dm)) for the details for each codec. PPPPaaaaggggeeee 2222 ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) PPPPCCCCMMMM MMMMAAAAPPPPPPPPIIIINNNNGGGG PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS An additional optional PCM mapping parameter set may be specified for the output or (rarely) for the input in addition to the above. The following must either _a_l_l be specified or _n_o_n_e should be specified: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPCCCCMMMM____MMMMAAAAPPPP____SSSSLLLLOOOOPPPPEEEE DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPCCCCMMMM____MMMMAAAAPPPP____IIIINNNNTTTTEEEERRRRCCCCEEEEPPPPTTTT DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPCCCCMMMM____MMMMAAAAPPPP____MMMMAAAAXXXXCCCCLLLLIIIIPPPP DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPCCCCMMMM____MMMMAAAAPPPP____MMMMIIIINNNNCCCCLLLLIIIIPPPP The default input and output values of these four are set automatically by the configuration routine to match the specified input and output sample formats. They should only be specified if you have special mapping requirements, such as input data with a fixed offset (DC bias). See the aaaaffffIIIInnnnttttrrrroooo(3dm) manual page for a complete explanation of PCM Mapping. CCCCOOOONNNNVVVVEEEERRRRSSSSIIIIOOOONNNN PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS DDDDiiiitttthhhheeeerrrriiiinnnngggg PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss When performing conversions from larger into smaller data types (i.e., floating point to 16-bit integer or 16-bit integer to 8-bit integer), a dithering algorithm may be applied to reduce the quantization error distortion inherent in such conversions. This parameter is ignored if such a conversion is not happening: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDIIIITTTTHHHHEEEERRRR____AAAALLLLGGGGOOOORRRRIIIITTTTHHHHMMMM DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDIIIITTTTHHHHEEEERRRR____NNNNOOOONNNNEEEE (default) DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____DDDDIIIITTTTHHHHEEEERRRR____LLLLSSSSBBBB____TTTTPPPPDDDDFFFF (LSB TPDF dither) RRRRaaaatttteeee CCCCoooonnnnvvvveeeerrrrssssiiiioooonnnn PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss These affect the rate conversion algorithm, and are only used when the output sampling rate is not equal to the input rate: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____AAAALLLLGGGGOOOORRRRIIIITTTTHHHHMMMM DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE (default) DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____PPPPOOOOLLLLYYYYNNNNOOOOMMMMIIIIAAAALLLL____OOOORRRRDDDDEEEERRRR____1111 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____PPPPOOOOLLLLYYYYNNNNOOOOMMMMIIIIAAAALLLL____OOOORRRRDDDDEEEERRRR____3333 DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____SSSSTTTTOOOOPPPPBBBBAAAANNNNDDDD____AAAATTTTTTTTEEEENNNNUUUUAAAATTTTIIIIOOOONNNN DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____SSSSTTTTOOOOPPPPBBBBAAAANNNNDDDD____AAAATTTTTTTTEEEENNNNUUUUAAAATTTTIIIIOOOONNNN____77778888____DDDDBBBB (default) DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____SSSSTTTTOOOOPPPPBBBBAAAANNNNDDDD____AAAATTTTTTTTEEEENNNNUUUUAAAATTTTIIIIOOOONNNN____99996666____DDDDBBBB DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____SSSSTTTTOOOOPPPPBBBBAAAANNNNDDDD____AAAATTTTTTTTEEEENNNNUUUUAAAATTTTIIIIOOOONNNN____111122220000____DDDDBBBB PPPPaaaaggggeeee 3333 ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____TTTTRRRRAAAANNNNSSSSIIIITTTTIIIIOOOONNNN____BBBBAAAANNNNDDDDWWWWIIIIDDDDTTTTHHHH DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____TTTTRRRRAAAANNNNSSSSIIIITTTTIIIIOOOONNNN____BBBBAAAANNNNDDDDWWWWIIIIDDDDTTTTHHHH____1111____PPPPEEEERRRRCCCCEEEENNNNTTTT DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____TTTTRRRRAAAANNNNSSSSIIIITTTTIIIIOOOONNNN____BBBBAAAANNNNDDDDWWWWIIIIDDDDTTTTHHHH____11110000____PPPPEEEERRRRCCCCEEEENNNNTTTT DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____RRRRCCCC____JJJJIIIITTTTTTTTEEEERRRR____FFFFRRRREEEEEEEE____TTTTRRRRAAAANNNNSSSSIIIITTTTIIIIOOOONNNN____BBBBAAAANNNNDDDDWWWWIIIIDDDDTTTTHHHH____22220000____PPPPEEEERRRRCCCCEEEENNNNTTTT CCCChhhhaaaannnnnnnneeeellll CCCCoooonnnnvvvveeeerrrrssssiiiioooonnnn PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss (Channel Matrix) Allows specification of input to output channel routing via a matrix of values. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____CCCCHHHHAAAANNNNNNNNEEEELLLL____MMMMAAAATTTTRRRRIIIIXXXX This is a type DDDDMMMMffffllllooooaaaattttaaaarrrrrrrraaaayyyy which must be set and retrieved via ddddmmmmPPPPaaaarrrraaaammmmssssSSSSeeeettttFFFFllllooooaaaattttAAAArrrrrrrraaaayyyy(3dm) and ddddmmmmPPPPaaaarrrraaaammmmssssGGGGeeeettttFFFFllllooooaaaattttAAAArrrrrrrraaaayyyy(3dm), respectively. The data itself is a one-dimensional array of double-precision floating point numbers arranged as if it were an n x m matrix of values, where rows == output_channels and columns == input_channels. See the aaaaffffSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllMMMMaaaattttrrrriiiixxxx(3dm) manual page for a detailed explanation of this. CCCCoooonnnnvvvveeeerrrrtttteeeerrrr MMMMooooddddeeee PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss These parameters describe the manner in which the converter handles the input and output buffers. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPRRRROOOOCCCCEEEESSSSSSSS____MMMMOOOODDDDEEEE This is queried to determine which mode the converter will run in for the given set of parameters: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPRRRROOOOCCCCEEEESSSSSSSS____PPPPUUUUSSSSHHHH Converter will be processing a fixed number of input frames, producing a (possibly) variable amount of output. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____PPPPRRRROOOOCCCCEEEESSSSSSSS____PPPPUUUULLLLLLLL Converter will be producing a fixed number of output frames, processing a (possibly) variable amount of input. BBBBuuuuffffffffeeeerrrr LLLLeeeennnnggggtttthhhh PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss These are used to query the converter for the minimum allowable output buffer length in frames for a given input buffer length: DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____MMMMAAAAXXXX____RRRREEEEQQQQUUUUEEEESSSSTTTT____LLLLEEEENNNN An integer value > 0. This is a set-only value. DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____MMMMIIIINNNN____IIIINNNNPPPPUUUUTTTT____LLLLEEEENNNN An integer value, query-only. This will be the minimum allowable input buffer length in a pull-mode operation. PPPPaaaaggggeeee 4444 ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) ddddmmmmAAAACCCCSSSSeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) DDDDMMMM____AAAAUUUUDDDDIIIIOOOO____MMMMIIIINNNN____OOOOUUUUTTTTPPPPUUUUTTTT____LLLLEEEENNNN An integer value, query-only. This will be the minimum allowable output buffer length in a push-mode operation. These only need be set and queried if the audio data is being compressed, decompressed, or rate-converted. In all other cases, the output buffer length in frames will and must equal the input length. If an application wishes to query this parameter before each call to ddddmmmmAAAACCCCCCCCoooonnnnvvvveeeerrrrtttt, it may use the two auxiliary functions ddddmmmmAAAACCCCGGGGeeeettttMMMMiiiinnnnOOOOuuuuttttppppuuuuttttSSSSiiiizzzzeeee(3dm) or ddddmmmmAAAACCCCGGGGeeeettttMMMMiiiinnnnIIIInnnnppppuuuuttttSSSSiiiizzzzeeee(3dm) to retrieve this information. This eliminates the overhead of parsing DMparams lists. SSSSEEEEEEEE AAAALLLLSSSSOOOO dmACCreate(3dm), dmACConvert(3dm), dmACReset(3dm), dmACDestroy(3dm), dmACGetMinOutputSize(3dm), dmACGetMinInputSize(3dm) PPPPaaaaggggeeee 5555